home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / cat3 / MoveToplev.3 < prev    next >
Text File  |  1994-09-20  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. Tk_MoveToplevelWindow(3T)k Library Procedures
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      Tk_MoveToplevelWindow - Adjust the position of  a  top-level
  12.      window
  13.  
  14. SYNOPSIS
  15.      #include <tk.h>
  16.  
  17.      Tk_MoveToplevelWindow(_t_k_w_i_n, _x, _y)
  18.  
  19. ARGUMENTS
  20.      Tk_Window   _t_k_w_i_n   (in)      Token for top-level window  to
  21.                                    move.
  22.  
  23.      int         _x       (in)      New x-coordinate for the  top-
  24.                                    left  pixel of _t_k_w_i_n's border,
  25.                                    or the top-left pixel  of  the
  26.                                    decorative border supplied for
  27.                                    _t_k_w_i_n by the  window  manager,
  28.                                    if there is one.
  29.  
  30.      int         _y       (in)      New y-coordinate for the  top-
  31.                                    left  pixel of _t_k_w_i_n's border,
  32.                                    or the top-left pixel  of  the
  33.                                    decorative border supplied for
  34.                                    _t_k_w_i_n by the  window  manager,
  35.                                    if there is one.
  36. _________________________________________________________________
  37.  
  38.  
  39. DESCRIPTION
  40.      In general, a window should  never  set  its  own  position;
  41.      this  should  be  done  only  by the geometry manger that is
  42.      responsible for the window.  For top-level windows the  win-
  43.      dow  manager  is  effectively the geometry manager;  Tk pro-
  44.      vides interface code between the application and the  window
  45.      manager  to convey the application's desires to the geometry
  46.      manager.  The desired size for a top-level  window  is  con-
  47.      veyed  using  the  usual  Tk_GeometryRequest mechanism.  The
  48.      procedure Tk_MoveToplevelWindow may be used by  an  applica-
  49.      tion  to  request a particular position for a top-level win-
  50.      dow;  this procedure  is  similar  in  function  to  the  wm
  51.      geometry  Tcl command except that negative offsets cannot be
  52.      specified.  It is invoked by widgets such as menus that want
  53.      to appear at a particular place on the screen.
  54.  
  55.      When Tk_MoveToplevelWindow is called it doesn't  immediately
  56.      pass  on the new desired location to the window manager;  it
  57.      defers this action until all other outstanding work has been
  58.      completed, using the Tk_DoWhenIdle mechanism.
  59.  
  60.  
  61.  
  62.  
  63. Tk                                                              1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. Tk_MoveToplevelWindow(3T)k Library Procedures
  71.  
  72.  
  73.  
  74. KEYWORDS
  75.      position, top-level window, window manager
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Tk                                                              2
  130.  
  131.  
  132.  
  133.